D This program generates "word search" squares in which the player;tries to locate hidden words running in various directions.
C WordSquared is a copyrighted "careware" program. You may freelyAcopy and distribute all the files together but not separately. If<you use and enjoy WordSquared, ~you are encouraged to send aC~contribution which will be used to help us provide health care forF~poor children in Nigeria.~ See below under "Careware" and "Why care?"2for more information. Contributions may be sent to
SIM USA
P.O. Box 7900
Charlotte, NC 28241
EPlease include a notation that this is for Dr. Mike Blyth in Nigeria.CComments/questions on WordSquared should be sent to me (see below).
^Contents:
Quick Start
Using WordSquared
The CareWare Concept
Why care?
~Quick Start~
? The operation of this program is straightforward and rather@intuitive. You simply create and save a list of words, then open@one or more squares, fill them with words, and print them if you@wish. ~Before bothering with the instructions, you might like to@~simply try out the program.~ Just remember that F10 selects theAmain menu, Alt-F3 closes a window, and F6 selects the next window=on the desktop. Help is always available by using the F1 key.
> You can use the Tutor to help you quickly learn how to use?the program. Just press Alt-t and follow the instructions given
step by step.
? WordSquared includes the ability to edit and store lists of@words, to choose which directions the words may run, to size theAsquares, and to view and/or print the squares with or without the
"filler" characters.
^USING WordSquared
^Menus
D The main menu bar appears at the top of the screen. Pressing F10Aselects the menu, then cursor control keys are used to select the@required item. You may also use the Alt key plus the highlighted@key of the menu item (e.g. Alt-r for WordList), use the function@keys shown in the status bar at the bottom of the screen, or use
the mouse.
E Within dialog boxes (where options are set and word lists chosen)>use the tab and shift-tab keys to move among the fields. WhereDcheckboxes "~[ ]~" and "radio buttons - ~( )~" are used for options,Bpress the spacebar to turn the item on or off, or click the mouse.
^Windows
B The usual conventions are followed for windows. Windows can be=selected by pressing F6 to cycle to the next window, Alt-1 toBAlt-9 to select a numbered window, or by using the mouse. PressingEAlt-F3 or clicking on the "close box" (upper left hand corner) closesEthe window. Ctl-F5 or clicking on the resize box (lower right corner)?allows resizing. Ctl-F5 also allows moving the window, as does =grabbing the upper frame with the mouse. F5 or the zoom icon &(upper right corner) toggles the zoom.
^Program Operation
B There are two main steps to creating a word search. First, youDinput the list of words. Second, you open a square using the list of%words, fill the square, and print it.
(1) Word Lists
? Word Lists are created or edited using the "WordList" menu.B When you select the "Edit" item from this menu, you can chooseB an existing word list to edit, or enter the name of a new list
to create.
D Words should be entered one per line, unless you want a compound@ word (e.g. "New Mexico") to appear as an item in the square.< The order of the words has no effect. When the words are. stored, they are reordered alphabetically.
@ Several WordStar-like editing commands are available to mark6 and copy blocks (press F1 for help while editing).
@ Press alt-F3 to close the edit window and save the words (to= memory only), or "Esc" to cancel the edit without saving.E Whenever you move to another window, the words will automatically
be saved.
@ ~Note that "Save" only saves the list to memory but does not@ ~save it to the disk.~ To save to the disk, use the Save All@ choice in the System menu. It is not possible, at this time,> to save or restore only a single word list, so be careful!
(2) Word Squares
A Create a square by selecting "New" from the "Square" menu (or< press F4). You will be prompted for the name of the wordA list to use. Next, insert the words into the square using the? "Fill" menu item (or press F7). You can repeat this step as= many times as needed until you like the way the words areA distributed. Then select the "Garbage Fill" item, (or F8), toA fill in all the blank spaces. Finally, print the square using" the "Print" menu item (or F9).
^Square Options
C The "Options" item in the "Square" menu allows you to customizeCthe square. You can change the square's ~title~, which prints aboveAit. You may select which ~directions~ are allowed. For example, aBsimple square might only allow rightward, downward, and right+downEdiagonal words. The checkboxes below are set up for these directions.
~[ ] [ ] [ ]
~[ ] [x]
~[ ] [x] [x]
D The lower-right box represents words running diagonally down andDto the right, the lower-middle box represents words running straight@down, and the middle-right box words running horizontally to the?right. The "x" in a box represents an allowed direction. Toggle?a checkbox by moving the cursor to it (tab and shift-tab), then
pressing the space bar.
B You can also change the ~size~ of the square. Finally, you canAchange the ~stickiness~ from 1-20; sticky squares try hard to getDwords to overlap, while unsticky (loose) ones are more likely to let#them appear alone (not overlapped).
@ The ~Defaults~ item in the "Square" menu lets you change theEdefault settings for stickiness and directions. Whenever a new squareAis made, the default settings are used until you override them by
using the Options dialog.
^Printer Options
7The "Printer" menu lets you adjust printer parameters.
?(1) ~Printer class~: currently the only relevant distinction is? IBM vs. non-IBM printers. If you select IBM, that printer's> frame-drawing characters are used, otherwise the "+", "|",. and "-" characters are used for the frame.
D(2) ~Top margin, left margin, width~: The margins are just that, and4 the width is the total page width in characters.
B(3) Title & Square ~prefixes~: printer prefixes which are inserted? before the title is printed (e.g. to allow bold or expanded@ fonts) and before the rest of the square is printed (e.g. to> cancel bold). Special characters may be inserted using the@ backslash "\" followed by the 3-digit decimal character code# (e.g. \027 for the escape key).
A(4) ~Formfeed~: This check box selects whether or not you want toA skip to the top of the next page after the square is printed.
^System Menu
AThis menu contains items for saving and restoring word lists, andDfor reading this file. "Save All" saves (to disk) all the word listsAin their current state. "Load" clears all the word lists from theBprogram and then loads them from the disk file. Remember that thisEwill delete any lists you have made but not saved ~to the disk~ using
"Save All".
C(Future versions may be able to save and load individual lists, but
for now I'm keeping it simple.)
^Files
? WORDSQRD.EXE - The main program file. Compressed with LZEXE8 (automatically decompressed when run)
B WORDSQRD.DAT - Data file containing word lists and the current# printer options.
B WORDSQRD.REZ - Resource file containing menu bar, status line,@ help files and tutorial. Required for program
operation
^THE CAREWARE CONCEPT
@ You all know what shareware is: software freely distributed,@relying on payment of registration fees by honest people who end?up using the program. Well, I am trying something similar. I amBgiving away this program but asking users to contribute a donationCto some people who truly need it, poor Nigerian children. Will thisAwork? Who knows. But your generosity will help result in healthy,
happy children.
9 SIM USA is an IRS-registered non-profit organization.
^Why Care?
B I (Mike Blyth) am a pediatrician preparing to go (with my wifeDand three children) to Nigeria (West Africa) for the next four yearsBto help train Nigerian physicians, nurses, and health workers, andCto assist in a primary health care program. Nigeria's population isFalmost 1/2 as large as that of the USA, or 115 million people. In many#areas the health problems are huge.
> * 1/10 of Nigerian children die in the first year of life.
< * Another 1/10 children die in the next 4 years of life.
A * 2/3 of Nigerians do not have access to safe drinking water.
6 * 1/2 of all Nigerian children are undernourished.
A * Measles, pneumonia, and diarrhea are major killer diseases,C although they can be prevented or treated fairly easily given
some basic resources.
? * According to UNICEF figures, about 1 in 10 Nigerian women
die in childbirth.
C While I enjoy living and practicing in the USA, the problems of?children in the rest of the world obviously dwarf those of most=American kids and of ourselves. If it were my children, or my?neighbors', I couldn't stand by and watch. So how can we ignoreBthem just because they are distant? As Christians, our family alsoHwants to follow the example and command of Christ to love our neighbors,!and to give our lives for others.
E If you would like to know more about our work, third world healthCneeds, or how you can help, just ask us! (I'd also like to hear any0comments about the program, and about any bugs).
Mike Blyth, M.D.
c/o SIM USA
P.O. Box 7900
Charlotte, NC 28241
or before September 1, 1991:
3249-B Fay Avenue
Los Angeles, CA 90034
(213) 838-4312
CompuServe [73505,1045]
$------------------------------------
@WordSquared is written in Turbo Pascal 6.0 using the TurboVision@system, both by Borland. It was compacted using LZEXE by Fabrice
Bellard.
~ WORDSQUARED TUTOR
To go through the basic steps of!making a word search square, just#follow the instructions in this box
as they appear.
"Press F10 to access the menu, then#move the cursor to "Wo~r~dList" and"press ~Return~. Then press "E" for
Edit.
CHOOSE FILE BOX"This is a dialog box. You can move%to different parts by pressing ~Tab~.
%Now you will choose the list of words$which you want to create or edit. To&make a new list called "Mywords", just%type "Mywords" in the box at the top,
and press ~Return~.
&(To choose an old list, press ~Tab~ to$get to the menu, move the cursor bar'to the right list, and press ~Return~.)
EDIT WORDS WINDOW#Now you should have an empty window#labeled "Mywords". Just type in the#list of words which you want to put$into the word search. Each word goes$on a line by itself. You can use all
the editing keys as needed.
When finished, press F2.
!You can press Alt-F3 to close the%edit window if you want -- your words#are still safe. Or you can go ahead"and press F10, then "S" to get the!"Square" menu, then "N" to make a"new word search square (or F4 as a
shortcut).
"Now you are ready to make the word!search square. Go ahead and press
F10 again, then "S" to get the!"Square" menu, then "N" to make a"new word search square (or F4 as a
shortcut).
"As before, choose the word list to$use by (1) typing "Mywords" into the%box at the top, or (2) pressing ~Tab~"to get the menu then selecting the$file with the up & down cursor keys.
$When you've selected the file, press
return.
!Now you have the window with your$word search square. You can press F7%as often as you like to get the words!to fit in different ways. You can&press F10, "S", "O" to get the Options%box for changing square size and word(directions (shortcut: alt-O [letter O]).
#When you like the way the words are%arranged, press F10, "S", "G" to fill#the box with garbage characters (or
use F8 by itself).
%You can print the box now if you want"by pressing F10, "S", "P" (or just
F9). To change printer options,
press F10, "P" before printing.
#You can open more word squares with!the same or different word lists.!Use F6 to switch between windows,&or Alt-1 to Alt-9 to select a numbered!window. Commands such as fill and$print act only on the active window.
&Use Alt-F3 (or click on the close box)&to close a window, including this one.
!Press F10 to go to the main menu,"use the cursor keys or letter keys
to choose an item, and press F1
again for further help.
System Menu
#This allows you to save or load the
system data from the disk file,"WORDSQRD.STM. The data consists of!(1) All the word lists being used"(2) The printer options in effect.
!You can also see the on-line help"document/program information file.
Load System Data
Reloads (1) all word lists and!(2) the printer options, from the$disk. Any existing word list editing%windows will be closed. Any additions or changes made to word lists or
printer options since the last#"System Save" command will be lost.
Save System Data
$Saves to disk (1) all word lists and%(2) the current printer options. Note(that changes to a word list being edited%will not be saved to the disk if they%have not already been saved to memory%using the WordList Save command (F2).
%Wordlist commands allow you to manage$the lists of words which you want to#eventually insert into squares. The
choices are! - Edit: Create or edit a list% - Save: Save to memory a list you
are editing% - Delete: Permanently delete a list
Edit Word List
#You can use this command to edit an$existing list of words, or to create
a new list.
Remember Word List
&This command saves the current list of*words to ~memory~. The words are not saved*to your disk until the end of the program,'so do not turn off the computer without
exiting the program.
,Word lists in edit windows are automatically)remembered when the window is closed with(the alt-F3 command or the close box, and)whenever you switch to another window, so&the Remember command is seldom needed.
Delete Word List
'This command permanently deletes a word'list. You will be prompted for the name%of the list which you wish to delete.
Program Information
$Opens the same window which is shown'when the program begins, containing the
on-line documentation.
Windows
)The window menu allows you to switch from(one window to the next, to move windows,'and to resize them. You can also choose)a numbered window by pressing the Alt key
along with the window's number,'for example, Alt-4 for the window which
is numbered "4".
Next Window
$Makes the next window the active one((the one which will be on top, accepting
commands and input).
Zoom Window
$Makes the current window grow to its'maximum size, if it is currently small,%or to become small if it is currently'zoomed. Does not affect the contents of
the window.
Resize/Move Window
(Allows you to change a window's size and'to move it. Use the cursor keys to move+the window, the shift-cursor keys to change(the size, then press return when you are
done.
Squares
%This menu deals with the word squares
themselves. Items include, - New: Open a new window with a word square$ in it. You need to do this before& you can use any of the other square
commands.* - Insert Words: Fill in the words in your
word list.' - Garbage: Fill in all the blanks with
random characters.& - Options: Lets you change size, word% directions, title, and stickiness.
- Print: print the square.
New Square
(Open a new word search square window and(insert the words on the chosen list. You)will be prompted for the name of the list)to use. The program will choose a default*size which should be enough to fit all the%words, but you may change the size by
using the Options command.
Insert Words
(Inserts the words from the word list for'this square. If all cannot be inserted,'you will be told. Words are inserted in(reverse order of length (longest first),)and if one cannot be inserted, no attempt
is made to insert the rest.
$Can be repeated as often as desired.
Garbage Fill
(Fills all the blank spaces in the square
with random characters.
Options
(Allows you to customize your square. You,can change the size, the directions in which,the words may run, the title (which defaults*to the name of the word list used), or the("stickiness" of the square (how much the
words tend to run together).
Print Square
'Prints the currently active word search(square (the one being worked on, the one*on "top" of the desk, with the highlighted(window frame). Use the Printer item from.the main menu to adjust the printer functions.
Defaults
%Changes the default values for square)stickiness and directions allowed. If you(change the defaults, the new values will$apply to squares opened later in the'session. Changed default values are not(saved to the disk when the program ends.
Printer Options
.Allows you to customize the printer functions., - Choose between IBM and non-IBM printers,
for frame characters.
- Define margins( - Choose whether to skip to the top of
page after printing) - Define prefixes for the title and the
square.
Exit/Quit
)Ends the program and saves the word lists
to the disk.
Edit Words List
(This window allows you to edit or create*a list of words for later use in a square.
&Type one word on each line, unless you(actually want two or more words to occur!in a straight line in the square.
(WordStar commands can be used to select,
copy, and delete text:
Ctrl-k b: begin a block
Ctrl-k k: end a block
Ctrl-k c: copy the block) Ctrl-k y: delete the block (or just use
the delete key)
Ctrl-k h: unmark the block
(These commands can be used to copy words'from one list to another. Just mark the%block in one list with Ctrl-k b, then(Ctrl-k k, switch to the window where you#want to insert the words, and press
Ctrl-c to copy the block.
&You can also use the mouse to mark the&text to copy, but you probably need to%press Ctrl-k at the end of the block.
Word Square Window
'This window contains the square itself.%When you first open it, the words are*inserted automatically, but you can always&insert the words again and again using*F7, until you like the look of the square.
(Although the square looks rectangular on(the screen, it will generally print as a#square since extra spaces are added
between the letters.
(F8 fills in all the blanks with garbage,
completing the square.
(Alt-O [letter O] (or the Options item in'the Square menu) lets you customize the)square. For more information, press Alt-O
then F1 again.
)F9 prints the square. Be sure the printer
is on.
Printer Options
*This dialog window allows you to customize&the printer. Use the tab and shift-tab!keys to move among the fields, or
Alt plus the highlighted key.
((1) Printer type: Use the up/down cursor)keys to choose the appropriate selection.'Try ~IBM~ first as this generates nice-$looking borders. If you get garbage,
choose ~Other~.
%(2) Margins: left and top margins are&just that. The width is the total page*width. If you try to use compressed fonts,$the "square" will probably be a tall
rectangle instead!
&(3) Title & Square ~prefixes~: printer&prefixes which are inserted before the'title is printed (e.g. to allow bold or&expanded fonts) and before the rest of%the square is printed (e.g. to cancel bold). Special characters may be)inserted using the backslash "\" followed%by the 3-digit decimal character code# (e.g. \027 for the escape key).
$(4) Formfeed: this checkbox lets you$choose whether to skip to the top of the next page after printing the&square. Use the space bar to select or%turn off this option while the cursor"is on the box, or press Alt-F (you
see that "F" is highlighted).
Choosing a Word List
"Use this dialog box to choose your#word list. The same box is used for creating, editing, deleting, and#selecting a list for a word square.!You can type the name of the list"into the input line at the top, or#use the tab key to move to the list"of word lists, then up/down cursor
to choose the right one.
"Press return to accept the choice,
or "Esc" to cancel.
Word Square Options
%Use this dialog box to customize your%square. Use the tab/shift tab keys to&move among option fields. If you chose&~O~ptions, any changes will apply only&to the currently active square. If you(chose ~D~efaults, they will apply to any
squares created later.
$(1) ~Title:~ the title which will be
printed above your square.
*(2) ~Directions:~ selects which directions'words are allowed to run. Think of this"box as a compass with eight points&indicated by the eight checkboxes. For'example, the upper right box represents&words written upward and to the right,%while the lower middle box represents&those written downward. Select or turn'off each direction by moving the cursor%to the box (using tab and shift-tab),
then pressing the space bar.
~[ ] [ ] [ ]
~[ ] [x]
~[ ] [x] [x]
#(3) ~Size:~ changes the size of the$square in characters. The height and#width are always equal (since these
are ~squares~).
&(4) ~Stickiness:~ changes the tendency#of words to cluster. Enter a number#from 1 to 20, with 1 representing a#very loose square, and 20 one where
(.txt)